home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / afunct.z / afunct
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaaffffuuuunnnncccctttt((((3333GGGG))))                                                          aaaaffffuuuunnnncccctttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aaaaffffuuuunnnncccctttt - specify alpha test function
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaaffffuuuunnnncccctttt((((rrrreeeeffff,,,, ffffuuuunnnncccc))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 rrrreeeeffff,,,, ffffuuuunnnncccc
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _r_e_f    expects a reference value with which to compare source alpha at
  17.             each pixel.  This value should be in the range 0 through 255.
  18.  
  19.      _f_u_n_c   is a symbolic constant taken from the list below.  It identifies
  20.             the alpha comparison function:  AAAAFFFFNNNNEEEEVVVVEEEE, AAAAFFFFLLLLEEEESSSSSSSS, AAAAFFFFEEEEQQQQUUUUAAAA, AAAAFFFFLLLLEEEEQQQQUUUU,
  21.             AAAAFFFFGGGGRRRREEEEAAAA, AAAAFFFFNNNNOOOOTTTTEEEE, AAAAFFFFGGGGEEEEQQQQUUUU, and AAAAFFFFAAAALLLLWWWWAAAA.  AAAAFFFFAAAALLLLWWWWAAAA is the default.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      aaaaffffuuuunnnncccctttt makes the drawing of pixels conditional on the relationship of the
  25.      incoming alpha value with a reference constant value.  It is typically
  26.      used to avoid updating either the color or the z bitplanes of a
  27.      framebuffer pixel when the incoming pixel is completely transparent.
  28.      Arguments _r_e_f and _f_u_n_c specify the conditions under which the pixel will
  29.      be drawn.  The incoming (source) alpha value is compared against _r_e_f with
  30.      function _f_u_n_c.  This comparison function is specified with the symbolic
  31.      constants:
  32.  
  33.      AAAAFFFFNNNNEEEEVVVVEEEE     Never pass.
  34.  
  35.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is less than _r_e_f.
  36.  
  37.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is equal to _r_e_f.
  38.  
  39.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is less than or equal to _r_e_f.
  40.  
  41.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is greater than _r_e_f.
  42.  
  43.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is greater than or equal to _r_e_f.
  44.  
  45.      AAAAFFFFNNNNEEEEVVVVEEEE     Pass if alpha is not equal to _r_e_f.
  46.  
  47.      AAAAFFFFNNNNEEEEVVVVEEEE     Always pass.
  48.  
  49.      If the comparison passes, the incoming pixel is drawn (conditional on
  50.      subsequent other tests like z-buffer).
  51.  
  52.      aaaaffffuuuunnnncccctttt can be called with arguments 0000,,,,AAAAFFFFNNNNOOOOTTTTEEEE to defeat drawing of
  53.      completely transparent pixels.  This assumes that incoming alpha is
  54.      proportional to pixel coverage, as it is when either ppppooooiiiinnnnttttssss or lllliiiinnnneeeessssmmmm is
  55.      being used.
  56.  
  57.      aaaaffffuuuunnnncccctttt testing follows scan conversion and texture mapping but precedes
  58.      all other pixel tests.  Thus, if the test fails, color, zbuffer and
  59.      stencil contents will not be modified.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaffffuuuunnnncccctttt((((3333GGGG))))                                                          aaaaffffuuuunnnncccctttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      aaaaffffuuuunnnncccctttt operates on all pixel writes, including those resulting from the
  75.      scan conversion of points, lines, and polygons, and from pixel write and
  76.      copy operations. aaaaffffuuuunnnncccctttt does not affect screen clear operation, however.
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      blendf
  80.  
  81. NNNNOOOOTTTTEEEESSSS
  82.      IRIS-4D G, GT, and GTX models, and the Personal Iris, do not support
  83.      aaaaffffuuuunnnncccctttt.  Use ggggeeeettttggggddddeeee to determine what support is available for aaaaffffuuuunnnncccctttt.
  84.  
  85. BBBBUUUUGGGGSSSS
  86.      On IRIS-4D VGX, XS, XS24, XZ, Elan and Extreme models, aaaaffffuuuunnnncccctttt cannot be
  87.      enabled while sssstttteeeennnncccciiii is being used.  Also on these models, only AAAAFFFFNNNNOOOOTTTTEEEE
  88.      with _r_e_f equal to 0 and AAAAFFFFAAAALLLLWWWWAAAA are supported.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.